[Live Debugger] Add instructions for Go (limited preview) #32935

piob-io · 2025-11-19T18:35:50Z

https://datadoghq.atlassian.net/browse/DEBUG-4711

What does this PR do? What is the motivation?

Update docs for Live Debugger for Go for limited preview.

Merge instructions

Merge readiness:

Ready for merge

For Datadog employees:

Your branch name MUST follow the <name>/<description> convention and include the forward slash (/). Without this format, your pull request will not pass CI, the GitLab pipeline will not run, and you won't get a branch preview. Getting a branch preview makes it easier for us to check any issues with your PR, such as broken links.

If your branch doesn't follow this format, rename it or create a new branch and PR.

[6/5/2025] Merge queue has been disabled on the documentation repo. If you have write access to the repo, the PR has been reviewed by a Documentation team member, and all of the required checks have passed, you can use the Squash and Merge button to merge the PR. If you don't have write access, or you need help, reach out in the #documentation channel in Slack.

Additional notes

github-actions · 2025-11-19T18:39:57Z

Preview links (active after the `build_preview` check completes)

New or renamed files

https://docs-staging.datadoghq.com/piob-io/go/tracing/trace_collection/dynamic_instrumentation/enabling/go

Modified Files

rtrieu · 2026-01-06T18:13:03Z

Created DOCS-13027 for docs review.

shatzi

looks good. small comment on installation structure

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

piob-io · 2026-01-08T16:59:18Z

Thanks @rtrieu, fixing the runtime toggle in #33730.

piob-io · 2026-01-09T15:48:00Z

Integrated the runtime toggle fix.

domalessi

Thanks for all the work on this PR! I left a handful of comments/questions/suggestions. Give everything a read-through, and let me know if you have any questions. Hit me up when this is ready for another look!

content/en/tracing/live_debugger/_index.md

content/en/tracing/trace_collection/dynamic_instrumentation/_index.md

domalessi · 2026-01-12T20:11:46Z

content/en/tracing/trace_collection/dynamic_instrumentation/_index.md

 - For Node.js applications, tracing library [`dd-trace-js`][18] 5.39.0 or higher.
 - (Limited Preview) For Ruby applications, tracing library [`dd-trace-rb`][19] 2.9.0 or higher.
 - (Limited Preview) For PHP applications, tracing library [`dd-trace-php`][20] 1.5.0 or higher.
+- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=1.74.6 or >=2.2.3.


I'm confused why we need both?

Suggested change

- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=1.74.6 or >=2.2.3.

- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=1.74.6.

The dd-trace-go library is undergoing a long process of transitioning to a new major version, that has incompatible API. Some users already switched to new version, some didn't, we need to cater for both. So the support for our product has been backported to previous major version as well.

Ah, okay, got it. I think then maybe something like this??

- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=v1.74.6 (major version 1), or >=v2.2.3 (major version 2).

Done (without a v before the number though, for consistency).

content/en/tracing/trace_collection/dynamic_instrumentation/_index.md

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

Co-authored-by: domalessi <[email protected]>

piob-io

Thank you, suggestions applied.

content/en/tracing/trace_collection/dynamic_instrumentation/_index.md

piob-io · 2026-01-13T16:08:51Z

content/en/tracing/trace_collection/dynamic_instrumentation/_index.md

 - For Node.js applications, tracing library [`dd-trace-js`][18] 5.39.0 or higher.
 - (Limited Preview) For Ruby applications, tracing library [`dd-trace-rb`][19] 2.9.0 or higher.
 - (Limited Preview) For PHP applications, tracing library [`dd-trace-php`][20] 1.5.0 or higher.
+- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=1.74.6 or >=2.2.3.


The dd-trace-go library is undergoing a long process of transitioning to a new major version, that has incompatible API. Some users already switched to new version, some didn't, we need to cater for both. So the support for our product has been backported to previous major version as well.

piob-io · 2026-01-13T16:18:53Z

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

+
+{{< tabs >}}
+{{% tab "Configuration YAML file" %}}
+Update your `system-probe.yaml` file with:


I think in this case it's always system-probe.yaml (that's how the agent knows which component the config applies to). When it's a helm chart (the last tab), then it's up to the user (the config internally encodes what config fragments are for what component). Added a link to the documentation.

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

piob-io · 2026-01-13T16:31:30Z

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

+    Note that <a href="#limitations">some limitations</a> apply to the preview.
+{{< /beta-callout-private >}}
+
+Dynamic Instrumentation is a feature of supporting Datadog tracing libraries.


Weird indeed. Suggested a different phrasing. Saying about plural "Datadog tracing libraries" refers to one library per language. But we are already on a language-specific page. I omitted explanation what the feature is, this is just an enablement page. This intro to my mind just sets the expectation, that users needs to use the APM tracing libraries.

domalessi

Thanks for all the changes, @piob-io ! V close, I think. Left a handful of additional comments. Give those a look-through and let me know when ready for a final check.

content/en/tracing/live_debugger/_index.md

domalessi · 2026-01-13T23:17:27Z

content/en/tracing/trace_collection/dynamic_instrumentation/_index.md

 - For Node.js applications, tracing library [`dd-trace-js`][18] 5.39.0 or higher.
 - (Limited Preview) For Ruby applications, tracing library [`dd-trace-rb`][19] 2.9.0 or higher.
 - (Limited Preview) For PHP applications, tracing library [`dd-trace-php`][20] 1.5.0 or higher.
+- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=1.74.6 or >=2.2.3.


Ah, okay, got it. I think then maybe something like this??

- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=v1.74.6 (major version 1), or >=v2.2.3 (major version 2).

domalessi · 2026-01-13T23:19:21Z

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/dotnet.md

 ---

-Dynamic Instrumentation is a feature of supporting Datadog tracing libraries. If you are already using [APM to collect traces][1] for your application, ensure your Agent and tracing library are on the required version. Then, go directly to enabling Dynamic Instrumentation in step 4.
+Dynamic Instrumentation is a feature provided by the Datadog tracing library. If you are already using [APM to collect traces][1] for your application, ensure your Agent and tracing library are on the required version. Then, go directly to enabling Dynamic Instrumentation in step 4.


I've been told we're trying to move away from "tracing library" and instead say "Datadog SDK", but that might require a finer comb-through. Created a Jira to track! https://datadoghq.atlassian.net/browse/DOCS-13107

Gtk, thanks. Yeah, for now let's keep it more consistent.

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/python.md

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

domalessi · 2026-01-13T23:31:39Z

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

+   DD_DYNAMIC_INSTRUMENTATION_ENABLED=true
+   ```
+
+3. Configure Unified Service Tags so that you can filter and group your instrumentations and target active clients across these dimensions:


Can we link to USTs here? https://docs.datadoghq.com/getting_started/tagging/unified_service_tagging/?tab=kubernetes

domalessi · 2026-01-13T23:33:39Z

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

+4. Restart your service.
+5. After the service starts, you can add and manage instrumentations from the [**APM** > **Live Debugger**][3] page.
+
+## Configuration


It's a little confusing to me to have this section here since we already cover setting these env vars in the above sections. If we want to include this consolidated table, maybe we rename the title? So that people know it's just a reference? Or we delete the table entirely and add the details about DD_SERVICE, etc into the steps above where we first mention them.

Removed, I think with the link to UST docs, that's enough.

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

Co-authored-by: domalessi <[email protected]>

piob-io

Thank you!

piob-io · 2026-01-13T23:49:41Z

content/en/tracing/trace_collection/dynamic_instrumentation/_index.md

 - For Node.js applications, tracing library [`dd-trace-js`][18] 5.39.0 or higher.
 - (Limited Preview) For Ruby applications, tracing library [`dd-trace-rb`][19] 2.9.0 or higher.
 - (Limited Preview) For PHP applications, tracing library [`dd-trace-php`][20] 1.5.0 or higher.
+- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=1.74.6 or >=2.2.3.


Done (without a v before the number though, for consistency).

piob-io · 2026-01-13T23:50:12Z

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/dotnet.md

 ---

-Dynamic Instrumentation is a feature of supporting Datadog tracing libraries. If you are already using [APM to collect traces][1] for your application, ensure your Agent and tracing library are on the required version. Then, go directly to enabling Dynamic Instrumentation in step 4.
+Dynamic Instrumentation is a feature provided by the Datadog tracing library. If you are already using [APM to collect traces][1] for your application, ensure your Agent and tracing library are on the required version. Then, go directly to enabling Dynamic Instrumentation in step 4.


Gtk, thanks. Yeah, for now let's keep it more consistent.

piob-io · 2026-01-13T23:51:36Z

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md

+4. Restart your service.
+5. After the service starts, you can add and manage instrumentations from the [**APM** > **Live Debugger**][3] page.
+
+## Configuration


Removed, I think with the link to UST docs, that's enough.

piob-io · 2026-01-16T14:26:31Z

@domalessi any more comments?

piob-io force-pushed the piob-io/go branch 2 times, most recently from 2509435 to 4b518dc Compare November 19, 2025 20:07

github-actions bot added the Architecture Everything related to the Doc backend label Nov 19, 2025

piob-io force-pushed the piob-io/go branch 2 times, most recently from b4fe31c to 6a8ea0f Compare November 21, 2025 13:09

piob-io force-pushed the piob-io/go branch from 6a8ea0f to e08c2fb Compare January 6, 2026 13:36

piob-io marked this pull request as ready for review January 6, 2026 14:07

piob-io requested review from a team as code owners January 6, 2026 14:07

piob-io requested review from shatzi and tylfin January 6, 2026 14:07

rtrieu added the editorial review Waiting on a more in-depth review label Jan 6, 2026

shatzi approved these changes Jan 8, 2026

View reviewed changes

content/en/tracing/trace_collection/dynamic_instrumentation/enabling/go.md Show resolved Hide resolved

piob-io force-pushed the piob-io/go branch 2 times, most recently from b7bbd68 to de12155 Compare January 8, 2026 17:18

[Live Debugger] Add instructions for Go (limited preview)

e0dc617

piob-io force-pushed the piob-io/go branch from de12155 to e0dc617 Compare January 9, 2026 15:45

domalessi reviewed Jan 12, 2026

View reviewed changes

Apply suggestions from code review

aa6e838

Co-authored-by: domalessi <[email protected]>

piob-io force-pushed the piob-io/go branch from 8e72834 to aa6e838 Compare January 13, 2026 16:45

piob-io requested a review from a team as a code owner January 13, 2026 16:45

piob-io commented Jan 13, 2026

View reviewed changes

piob-io requested a review from domalessi January 13, 2026 16:49

domalessi reviewed Jan 13, 2026

View reviewed changes

Apply suggestions from code review

93a4543

Co-authored-by: domalessi <[email protected]>

piob-io force-pushed the piob-io/go branch from e00cf95 to 93a4543 Compare January 14, 2026 00:00

piob-io commented Jan 14, 2026

View reviewed changes

piob-io requested a review from domalessi January 14, 2026 22:27

tylfin mentioned this pull request Jan 16, 2026

docs(debugger): update setup requirements & reorg #33941

Draft

1 task

	- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=1.74.6 or >=2.2.3.
	- (Limited Preview) For Go applications, tracing library [`dd-trace-go`][21] >=1.74.6.

[Live Debugger] Add instructions for Go (limited preview) #32935

Are you sure you want to change the base?

[Live Debugger] Add instructions for Go (limited preview) #32935

Uh oh!

Conversation

piob-io commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this PR do? What is the motivation?

Merge instructions

Additional notes

Uh oh!

github-actions bot commented Nov 19, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Preview links (active after the build_preview check completes)

New or renamed files

Modified Files

Uh oh!

rtrieu commented Jan 6, 2026

Uh oh!

shatzi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

piob-io commented Jan 8, 2026

Uh oh!

piob-io commented Jan 9, 2026

Uh oh!

domalessi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

piob-io left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

domalessi left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

piob-io commented Nov 19, 2025 •

edited

Loading

github-actions bot commented Nov 19, 2025 •

edited

Loading

Preview links (active after the `build_preview` check completes)